<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Secondary Databases</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Getting Started with Distributed Berkeley DB Applications" />
    <link rel="up" href="client.html" title="Chapter 3. Berkeley DB Client Driver APIs" />
    <link rel="prev" href="client.stat_api.html" title="Statistic Functions" />
    <link rel="next" href="client.concurrency.html" title="Multi-Threaded Applications" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 12.1.6.2</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Secondary Databases</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="client.stat_api.html">Prev</a> </td>
          <th width="60%" align="center">Chapter 3. Berkeley DB Client Driver APIs</th>
          <td width="20%" align="right"> <a accesskey="n" href="client.concurrency.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title" style="clear: both"><a id="client.secondary"></a>Secondary Databases</h2>
          </div>
        </div>
      </div>
      <p> 
            The secondary-key callback configured for a secondary database is
            called at the client node only. To make it work, the client driver
            tries to maintain enough information for the callback. However,
            certain operations are still not supported by the client driver. 
        </p>
      <div class="itemizedlist">
        <ul type="disc">
          <li>
            <p> 
                    Partial update is not supported on databases that have
                    associated secondary databases.
                </p>
          </li>
          <li>
            <p>
                    <code class="classname">Cursor.putAfter()</code>,
                    <code class="classname">Cursor.putBefore()</code> or
                    <code class="classname">Cursor.putCurrent()</code> cannot be
                    called immediately after a multiple-key get operation on the
                    same cursor. A multiple-key get operation is a get operation
                    where the data parameter is an instance of
                    <code class="classname">SMultiplePairs</code>. 
                </p>
          </li>
        </ul>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="client.stat_api.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="client.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="client.concurrency.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Statistic Functions </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Multi-Threaded Applications</td>
        </tr>
      </table>
    </div>
  </body>
</html>
